home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINPROGS / GC101C.ZIP / GOCIS.TPL < prev    next >
Text File  |  1993-11-19  |  20KB  |  615 lines
  1. ;***************************************************************
  2. ;* GoCIS Commands Commands                                    *
  3. ;***************************************************************
  4. ;
  5. ; REMOVE or SET ACTION flags for forum as tasks are completed
  6. ; 
  7. ; REMOVEACTION &&FORUMNAME Join.Forum
  8. ; SETACTION    &&FORUMNAME Set.Defaults
  9. ;
  10. ; Valid action flags
  11. ; Join.Forum
  12. ; Set.Defaults
  13. ; Update.Sections
  14. ; Read.Announcements
  15. ; Scan.New.Messages
  16. ; Read.Messages
  17. ; Send.Replies
  18. ; Read.New.Messages
  19. ; Read.Waiting.Messages
  20. ; Scan.Libraries
  21. ; Download.Files
  22. ; Upload.FIles
  23. ;
  24. ;
  25. ;
  26. ;  GO           forum_name
  27. ;  RESET
  28. ;  KILLFILE     filename
  29. ;  KILLDIR      directory
  30. ;  MAKEDIR      directory
  31. ;  LIB          library_number
  32. ;
  33. ;  SCANMES
  34. ;  SCANTHR
  35. ;  SCANLIB
  36. ;  QSCNLIB
  37. ;
  38. ;  JOIN
  39. ;
  40. ;  DOWNLOAD     filename pathname
  41. ;
  42. ;  READSEC
  43. ;  READMES
  44. ;  READTHR
  45. ;  READANN
  46. ;  READMAIL
  47. ;
  48. ;  RECORD
  49. ;
  50. ;  DO           scriptfile
  51. ;
  52. ;  LOGOFF
  53. ;  OFF
  54. ;  QUIT
  55. ;
  56. ;  S
  57. ;  SE
  58. ;  SEND         text
  59. ;
  60. ;  U
  61. ;  W
  62. ;  WA
  63. ;  WAIT         text
  64. ;
  65. ;  P
  66. ;  PA
  67. ;  PAUSE        number_of_seconds
  68. ;
  69. ;  C
  70. ;  CA
  71. ;  CAPTURE      filename
  72. ;
  73. ;  PR
  74. ;  PRINT        ON, or OFF
  75. ;
  76. ;  LOG          text
  77. ;
  78. ;  EC
  79. ;  ECHO         text
  80. ;               ON, or OFF
  81. ;
  82. ;  EN
  83. ;  END
  84. ;
  85. ;  N
  86. ;  NA
  87. ;  NAME
  88. ;
  89. ;  US
  90. ;  USER
  91. ;  USERID
  92. ;  RET
  93. ;  RETURN
  94. ;
  95. ;  DEBUG        ON, or OFF
  96. ;***************************************************************
  97. ;* GoCIS Variables                                            *
  98. ;***************************************************************
  99. ;       GoCIS Variables are denoted by a single & characters &
  100. ;       these variables are replaced with string values at the
  101. ;       time GoCIS executes the script.
  102. ;
  103. ; "&USERID"             CompuServe      UserID
  104. ; "&NAME"                               UserName
  105. ; "&PASSWORD"                           User Password
  106. ; "&GATEWAY"            Current Gateway
  107. ; "&FORUM"              Current Forum
  108. ;
  109. ;***************************************************************
  110. ;* GoCIS Conditional Commands                                 *
  111. ;***************************************************************
  112. ;
  113. ;
  114. ;     '%', '?' or '@'   are prefix condition characters that can
  115. ;                       prefix any command in order to make the
  116. ;                       command conditional on the success of any
  117. ;                       prior command.
  118. ;
  119. ;       Each occurrence of these prefix conditions denotes a
  120. ;       level of nesting that should be considered prior to
  121. ;       executing the command. Up to 10 levels of nesting
  122. ;       (or 10 prefix conditions) can be checked.
  123. ;
  124. ;       Basically processing proceeds as follows:
  125. :
  126. ;       For each Prefix condition:
  127. ;
  128. ;       For I = 0 to the Number-of-Prefix-Conditions
  129. ;               If The_Condition_At(I) = FALSE Then Skip This Command
  130. ;       Next
  131. ;
  132. ;       All Conditions are true So Perform the command and save the return code...
  133. ;
  134. ;       ReturnCode = Command()
  135. ;
  136. ;       If the command worked then ReturnCode = TRUE Else ReturnCode  = FALSE
  137. ;
  138. ;       Now set the next higher condition to the value of the ReturnCode so that
  139. ;       Other commands can be based on the success of the command just executed
  140. ;
  141. ;       Set The_Condition_At(Number-Of-Prefix-Conditions + 1) = ReturnCode
  142. ;
  143. ;
  144. ;       The Prefix Conditions Denote the following conditions
  145. ;
  146. ;
  147. ;      %   Defines a TRUE  condition at this error level
  148. ;      @   Defines a FALSE condition at this error level
  149. ;      ?   Defines a Don't Care Condition at this  error level
  150. ;
  151. ;
  152. ;       The following is an example of some of the concepts presented:
  153. ;
  154. ;
  155. ;       GO FORUM
  156. ;       ; This command will always be executed since there are no
  157. ;       ; prefix conditions.  If GoCIS successfully enters the FORUM
  158. ;       ; then the condition at level 1 will be set to TRUE otherwise it
  159. ;       ; will be set to FALSE
  160. ;
  161. ;       %ECHO We entered the FORUM successfully
  162. ;       ; The ECHO command will execute only if the condition at level 1 is TRUE
  163. ;       ; The ECHO Command does not return a condition and therefore does not
  164. ;       ; affect the condition at level 2
  165. ;
  166. ;       %LIB 1
  167. ;       ; We will only go to library 1 if the condition at level 1 is TRUE
  168. ;       ; this of course depends on that success of the GO FORUM Command
  169. ;       ; If the command is executed it will set the condition at Level 2
  170. ;
  171. ;       %%SCANLIB KEY:PROGRAMS LIB:ALL
  172. ;       ; Scanning for programs will depend of the success of getting to the Library Prompt
  173. ;       ; Therefore this command depends of the success of both the GO FORUM and LIB 1
  174. ;       ; commands.  Here we test 2 levels of prefix conditions denoted by the fact that
  175. ;       ; there are 2 '%' characters prefixing the SCANLIB Command
  176. ;       ; If the command is executed it will set the condition at Level 3
  177. ;
  178. ;       %@ECHO Can't Enter library 1 of the FORUM
  179. ;       ; This command will only be executed if we successfully entered the forum
  180. ;       ; and were unable to enter the library.  Since the first prefix_condition is
  181. ;       ; an % the condition at level 1 must be true, this was set by the value returned
  182. ;       ; by the GO FORUM command. If GO FORUM was not successful the command would be skipped
  183. ;       ; The second prefix_condition @ indicates that the condition at level 2 must be FALSE
  184. ;       ; this condition was last established by the %LIB 1 command.
  185. ;       ; The ECHO Command does not return a condition and therefore does not
  186. ;       ; affect the condition at level 3
  187. ;
  188. ;       @ECHO Can't Enter the FORUM
  189. ;       ; This command will only be executed if the GO FORUM command was unsuccessful
  190. ;       ; the @ indicates that the condition at level 1 must be FALSE.  This of course
  191. ;       ; was last set by the GO FORUM command.
  192. ;
  193. ;
  194. ;***************************************************************
  195. ;* Template Variables                                          *
  196. ;***************************************************************
  197. ;
  198. ;       Template Variables are denoted by the characters &&
  199. ;       these variables are replaced with string values at the
  200. ;       time GoCIS generates the script.  Don't confuse template
  201. ;       variables with script variables.  Script variables are
  202. ;       evaluated when the script is executed by GoCIS
  203. ;
  204. ;
  205. ;
  206. ; "&&USERID"        CompuServe UserID
  207. ; "&&USERNAME"                 UserName
  208. ; "&&PHONENUMBER"              PhoneNumber
  209. ; "&&LOGONSCRIPT"              LogonScript
  210. ;
  211. ; "&&GATEWAY"         Forum    Gateway
  212. ; "&&FORUMNAME"                Name
  213. ; "&&FORUMTITLE",              Title
  214. ; "&&CONTROLPATH"     Path For Control Files
  215. ; "&&DOWNLOADPATH"             Downloads
  216. ; "&&MESSAGEPATH"              Messages
  217. ; "&&SCRIPTPATH"               Scripts
  218. ;
  219. ; "&&LIBRARY"         Library  Number
  220. ; "&&DOWNLOADFILE"    Download FileName
  221. ; "&&DOWNLOADSIZE"             Filesize
  222. ; "&&DOWNLOADDATE"             Filedate
  223. ; "&&DOWNLOADCOUNT"            #DownLoads
  224. ; "&&DOWNLOADUPLD"             Uploaded by this CIS User
  225. ; "&&DOWNLOADTITLE"            Title Description of File
  226. ;
  227. ; "&&SCANFILE"        LibraryScan FileName
  228. ; "&&SCANAGE"                     Days old or age
  229. ; "&&SCANLIBS"                    Libraries to scan through
  230. ; "&&SCANKEYWORDS"                Keywords to look for
  231. ; "&&SCANTYPE"                    Short or long descriptions
  232. ; "&&SCANDESC"                    Description of this scan
  233. ;
  234. ; "&&READMSGSECTION"  ReadMessage Section Number
  235. ; "&&READMSGNUMBNER"              Thread or Message Number
  236. ;
  237. ; "&&VERSION"         GoCIS Version Number
  238. ; "&&DATE"            Date script was created
  239. ; "&&TIME"            Time script was created
  240. ;
  241. ;
  242. ;
  243. ;
  244. [PROLOG]
  245. ;
  246. ; This script file was created on &&DATE at &&TIME by &&USERNAME.
  247. ;
  248. ;***********************************************************************
  249. ;       GoCIS &&VERSION
  250. ;       Copyright(C) 1992
  251. ;       Larry Lee (76670,1471)
  252. ;       16038 Augusta Drive
  253. ;       Chino Hills, Ca 91709
  254. ;***********************************************************************
  255. ;
  256. ;
  257. WAI